home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / qrfm36a.zip / QRFM.DOC < prev    next >
Text File  |  1992-09-03  |  52KB  |  956 lines
  1.  
  2.                              QRFM Ver 3.6a              3 Sept 1992
  3.  
  4.                 (c) Copyright 1991 by John Jamieson
  5.                          All Rights Reserved
  6.  
  7.   Intro:
  8.  
  9.     QRFM is a BBS File Manager, you should be able to handle all your
  10.     BBS file management chores from this platform. QRFM is designed
  11.     especially for the BBS with Limited Hard Disk space and without a
  12.     Backup Tape Drive. I think a lot of us have Boards that fit this
  13.     description. QRFM uses a data base to manage online files in the
  14.     Upload and DownLoad directories and offline files residing on
  15.     floppies. This system makes it possible to run a BBS with a large
  16.     complement of offline files. Offline files are easely placed back on
  17.     line, QRFM tells you what floppy disk it needs in order to return
  18.     a file to a download directory.
  19.  
  20.     Although QRFM was designed with QuickBBS Vers 2.75 and Remote Access
  21.     Vers 1.10/1.11 in mind. It should be useable with any BBS that uses
  22.     Files.BBS to record file descriptions.
  23.  
  24.     SrchDoor.EXE included in the package, will omly work with QuickBBS
  25.     Vers 2.75 or Remote Access Vers 1.10/1.11. It will not work with
  26.     other BBS systems as it requires ConFig.RA or QuickCfg.Dat and the
  27.     associated ExitInfo.BBS.
  28.  
  29.     If you run QRFM under DesqView give QRFM a 535k window. I have
  30.     had problems running in smaller windows. I haven't had time to run
  31.     tests to determine the minimum memory requirements. Inadaquate
  32.     memory can cause a duplicate entry to appear in the newfiles key list.
  33.     It shows up when using search door to list new files. If it happens
  34.     you will have to run REBLDIDX.EXE to rebuild the keys. Not a big deal
  35.     but avoiding the problem with adaquate memory avoids the problem.
  36.  
  37.     Qrfm Features:
  38.  
  39.      a) Move files from the Upload area to a DownLoad area, between
  40.         DownLoad areas and between Download areas and BackUp flopies.
  41.      b) Edit File Description, Name or Date. The description editor
  42.          allows the use of 240 character descriptions.
  43.      c) Check/View/Alter the contents of an Archive,
  44.          (Shells to your Archive programs then your File Manager)
  45.      d) Recompress File to different Compression type,
  46.          (Shells to your Archive programs).
  47.      e) Check for Virus, (shells to your virus checker).
  48.      f) Backup Files to Floppy and Catalog those backups.
  49.          Files are backed up and the backups cataloged, makeing it
  50.          possible to take files offline and put them back on line
  51.          easily. Backup file copies are kept in groups in accordance
  52.          with assigments made when configuring file areas. Each download
  53.          area can be assigned a backup group or a group of download
  54.          areas can use the same backup group.
  55.      g) Delete unwanted files both online and backup copies.
  56.      h) Search for files by File Name or Key Word.
  57.      i) Produces a variety of file lists, including
  58.         .Cross Reference file lists in both .Ans and .Asc
  59.          format for display with Type 45 menu item.
  60.         .AllFile listings for a specified user level.
  61.         .File lists of selected file areas.
  62.      j) Pick List access to file information. Display includes Backup
  63.          disk number, name of Uploader, and the number of downloads as
  64.          well as description, size and date.
  65.      k) CDROM compatable
  66.  
  67.     SrchDoor Features:
  68.      a) Uses the Qrfm database to perform fast searches. Handy if File
  69.         Lists have gotten so large that the BBS searches are time consuming.
  70.         SrchDoor uses the QRFM indexs in New file and File Name searches.
  71.      b) Searches can be performed on all areas or they can be limited to
  72.         a collection of areas or one area.
  73.  
  74.  
  75.   Operation Overview:
  76.  
  77.    The Setup functions provide the system with the information that it
  78.    requires to operate.
  79.  
  80.    To exit the program Close any window that might be open by pressing
  81.    the F10 key or by clicking on the  [■] in upper left corner of the
  82.    window. then press Alt-x. You could also exit, selecting eXit on the
  83.    Exit SubMenu.
  84.  
  85.    PickLists are used to select files to be operated on by the File_Ops and
  86.    Offline_Ops menus. A the way it works is a file is selected from the
  87.    Pick List, use the Mouse or Arrow keys to make a selection. A High
  88.    Lighted file is a selected file, then without exiting the PickList window
  89.    select the File_Ops or Offline_ops menu and select the required operation.
  90.    The Pick_Lists menu offers 3 Lists the Upload, DownLoad and Not Backed up
  91.    Lists and in addition the menu has a function to Load New Uploads into
  92.    the data base. The Load New Uploads Function loads info on files not
  93.    previously loaded into the data base for use by the UpLoad PickList.
  94.  
  95.    File Ops menu is broken into two areas. The first contains functions
  96.    that operate on a file selected using one of the pick lists. The
  97.    second group of functions operate on files extracted from the
  98.    selected file and placed in the QRFM\Temp directory. The extracted
  99.    contents of an archive can be altered using a file manager, the files
  100.    can then be recompressed. Use this method to alter the contents of
  101.    Files, as any changes to a file's, date, size, or name will cause
  102.    conflicts with the data base, if changes are made to a file outside
  103.    the QRFM system. 
  104.  
  105.    The Offline Ops menu provides the tools for maintaining offline files.
  106.  
  107.    The Locator menu contains the search functions.
  108.  
  109.    The BBS Lists menu can Update the Files.BBS lists, Prepare an
  110.    AllFiles List and Reference Area Lists. But it's a good idea to set
  111.    up a maintenance event using the utility QRFMFLST.EXE to accomplish
  112.    the task. QRFMFLST.EXE will also handle the task of importing of
  113.    uploads. The AllFiles.Lst file and the cross Reference Area lists are
  114.    placed in the QRFM directory. When you make File Lists available for
  115.    download, use a directory that has not been entered in the QRFM
  116.    configuration. Since file lists are continually changing size it
  117.    would be a make work project trying to keep the QRFM data base up
  118.    to date. I have a seperate download directory for file lists and
  119.    offer a selection of different file lists.
  120.  
  121.   General Info:
  122.  
  123.    The Files.BBS files in both the Upload and Download file areas are
  124.    updated only when the BBS_Lists function [Update Files.BBS] is
  125.    selected or the utility QRFMLST.EXE is used to accomplish the update.
  126.    Prior to running [Update Files.BBS] Qrfm input is only recorded in
  127.    the QRFM data base.
  128.  
  129.    A Files.BBS must exist in every non CDROM area. Because in order to
  130.    support CDROM's, if QRFM dosen't find a Files.BBS file in the File
  131.    Area Directory it will assume that the area is a CDROM area and
  132.    description changes will be written to a FilesXX.BBS file in the
  133.    QRFM\Lists directory (the File Area Code will be used in place of XX
  134.    in FilesXX.BBS).  If for any reason the Files.BBS dosen't exist put a
  135.    dummy Files.BBS in that area so QRFM can replace it with an updated
  136.    one or move and rename the FilesXX.BBS, after it has been created)
  137.    from the lists directory to the File Area Directory.
  138.  
  139.    If you choose to use QRFM, all changes to the Files.BBS files and
  140.    files in the associated directories should be accomplished using QRFM
  141.    and it's utilities. Bypassing QRFM to make changes will leave the
  142.    data base out of sync. Most functions are handled from the QRFM
  143.    menus, but in some unusual cases you may have to be creative. Lets
  144.    say you want to add a readme file to a .ZIP file in one of the
  145.    download file areas. First highlite the file that will be added to
  146.    then press enter to decompress it. Then drop to DOS and add the
  147.    readme file to the decompressed package in the QRFM\TEMP directory.
  148.    Return to the program and recompress the file.
  149.  
  150.    To add files to the system it's best to just place them in the
  151.    Uploads directory and import them as with Uploads. Descriptions
  152.    can either be added using the QRFM editor or the Files.BBS could
  153.    be edited to pickup the new description. If the files were added
  154.    to a download directory you would have to run the QRFM utility
  155.    VerifDb to add the file to the QRFM database. This last approach
  156.    could be slow if VerifDb is working with a large data base.
  157.  
  158.    The importing of new files from the uploads directory into the QRFM
  159.    data base can be done automaticly using the utility QRFMFLST.EXE
  160.    during a system event or it can be accomplished from the Pick List
  161.    Menu item [Load New Uploads].
  162.  
  163.    QRFM does not allow duplicate file names even if the files have a
  164.    different extension or are in a different directory.  The uploads
  165.    directory will take the file but the name must be changed before
  166.    before the file can be moved to a download directory.
  167.  
  168.    QRFM can be used with or without a mouse. If running without a mouse
  169.    use the arrows keys to select menu items and the Tab key to Select
  170.    Entry fields or Selections. Main menu items are selected by pressing
  171.    the Alt key plus the HighLighted letter in the menu item description.
  172.    See KeyPress info below.
  173.  
  174.    Importing my Files.BBS and associated file info, 3,600 files, into
  175.    the QRFM data base took 4.5 hours on my 386SX, allow plenty of time
  176.    for this function.
  177.  
  178.    An associated Door, SRCHDOOR, Makes use of the QRFM data base to
  179.    provide improved search capability. SrchDoor does a very fast New
  180.    Files search or File Name search. In addition it will search all
  181.    lines in multi line descriptions.
  182.  
  183.    QRFM includes a File Cross Reference capability. A usage for
  184.    instance: Include all files including Pascal source code in a cross
  185.    list or include all files supporting VGA in a cross reference list.
  186.    Cross Reference Areas are created with Config menu item (File Areas).
  187.    Files can be taged for inclusion in up to 5 cross reference areas
  188.    using the File_Ops menu item (Add to Ref Area).
  189.  
  190.    When using the File Manager function, changes can be made to the
  191.    contents of a file. The File Manager works with files decompressed or
  192.    moved into the temp dir. If any changes are made to this decompressed
  193.    package, the Recompress function must be used to replace the
  194.    origional copy of the file.
  195.  
  196.    QRFM uses a database to manage quickbbs files. The location of files
  197.    on backup disks cannot be recontructed. For this reason it is
  198.    recommended that .DAT and .CFG files be backed up at least after
  199.    every session involving the backup of BBS down loadable files, or
  200.    the deletion of a file involving a floppy.
  201.  
  202.  
  203.   Setup:
  204.  
  205.     a.  Create a QRFM directory, a LISTS Subdirectory and a TEMP
  206.         Subdirectory and place QRFM.EXE and the utilities you intend to
  207.         use in the QRFM directory.
  208.  
  209.    C:\─┐
  210.        │
  211.        └─QRFM────────────┬─QRFM.EXE
  212.                          ├─SRCHDOOR.EXE
  213.                          ├─QRFMSRCH.EXE
  214.                          ├─QRFMFLST.EXE
  215.                          ├─CNTDN.EXE
  216.                          ├─UPBY.EXE
  217.                          ├─VERIFDB.EXE
  218.                          ├─REBLDIDX.EXE
  219.                          ├─QRFM.KEY
  220.                          │
  221.                          ├─TEMP (SubDir)
  222.                          └─LISTS (SubDir)──── *.HDR
  223.  
  224.          When you run QRFM for the first time the following files are
  225.          created in the QRFM directory.
  226.  
  227.                          │
  228.                          ├─QRFM.CFG
  229.                          ├─QRFMAREA.DAT
  230.                          ├─QRFMDESC.DAT
  231.                          ├─QRFMFILE.DAT
  232.                          ├─QRFMAREA.IDX
  233.                          ├─QRFMDATE.IDX
  234.                          ├─QRFMNBAK.IDX
  235.                          └─UPLFILE.IDX
  236.  
  237.  
  238.     The rest of the setup is handled from the Config menu.
  239.  
  240. ┌────────────────────────────────────────────────────────────────────┐
  241. │Exit  Pick_Lists  File_Ops  Offline_Ops  Locator  BBS_Lists  Config │
  242. └───────────────────────────────────────────────────────────────┬────┘
  243.                                                                 │
  244.                                                      ┌──────────┴──────────┐
  245.                                                      │ Directories         │
  246.                                                      │ File Areas          │
  247.                                                      │ Compression Methods │
  248.                                                      │ Other Externals     │
  249.                                                      │ Import Files.BBSs   │
  250.                                                      │ Backup Drive        │
  251.                                                      ├─────────────────────┤
  252.                                                      │ Import Files.BBSs   │
  253.                                                      └─────────────────────┘
  254.  
  255.  
  256.     b. The BBS Upload and DnLoad directories should contain the
  257.        Files.BBS and the files listed in the Files.BBS. Any other
  258.        files in the BBS Upload and DnLoad directories that you
  259.        don't want to appear in the data base should be removed.
  260.        Prior to running Import Files.BBS. Files not listed in
  261.        the Files.BBS will be included in the data base with a
  262.        dummy description. Any files that get past you can be
  263.        deleted later.
  264.     c. Change to the QRFM dir and Run QRFM. Allow QRFM to build
  265.        the Config files. Then select Setup and then complete the
  266.        Setup items. The BBS as it exists at present should be
  267.        reflected in these entries.
  268.        1. Directories: Enter the complete path names for your BBS
  269.           Program directory and your DownLoad Directory.
  270.  
  271.          ╔═[■]═════════════════ System Directory Config ════════════════╗
  272.          ║                                                              ║
  273.          ║                                                              ║
  274.          ║     BBS Directory       c:\Ra                                ║
  275.          ║                                                              ║
  276.          ║     Upload Directory    D:\newfiles                          ║
  277.          ║                                                              ║
  278.          ║                [  Ok  ]   [Cancel]                           ║
  279.          ║                                                              ║
  280.          ╚══════════════════════════════════════════════════════════════╝
  281.  
  282.        2. File Areas: Enter the complete path names for all of the
  283.           BBS File Download areas and File Cross Reference areas.
  284.           File Cross Reference Areas are explained in General Info
  285.           above.
  286.           All areas in use must be entered at this time. The Areas
  287.           ConFig window operates as follows.
  288.            The window opens in the [Add Area] configuration use the
  289.            mouse or Tab key to select the Area key field. Enter a
  290.            two character Area Key for a download area. This key will
  291.            be used by the system in all future record keeping. Use
  292.            the Mouse,Alt+ HighLighted Letter or Tab key to move to the
  293.            other entry fields and complete them. DON'T use the enter
  294.            key when entering Data it will switch you to [Pick Area].
  295.            When all the fields are complete, Select [Save].
  296.            The selection boxes have these functions.
  297.             [Add Area] formats entry fields for a new area.
  298.             [Add XRef Area] formats fields for a new cross reference area.
  299.             [Pick Area] will allow you to select an area from those
  300.              assigned, in order to make changes.
  301.             [Save] saves the current entry
  302.             [Delete] deletes an unused area.
  303.             [Done] or [Cancel] Exits the window, a click on the [■] in
  304.              upper left corner, or pressing F10 will also exit the window.
  305.  
  306.          ╔═[■]═══════════════ Areas Config ════════════════════╗
  307.          ║ 1A  ░                                               ║
  308.          ║ 1B  ░     Area Key      1A                          ║
  309.          ║ 1C  ░                                               ║
  310.          ║ 1D  ░ Access Level      5                           ║
  311.          ║ 1E  ░                                               ║
  312.          ║ 1F  ░   Description     Menu Systems                ║
  313.          ║ 1G  ░                                               ║
  314.          ║ 1H  ░     Area Path     H:\Menu                     ║
  315.          ║ 1I  ░                                               ║
  316.          ║ 1J  ░     BackUp Group 00 to 99  02                 ║
  317.          ║ 2A  ░                                               ║
  318.          ║ 2B  ░   [  Add Area  ]               [ Done ]       ║
  319.          ║ 2C  ░                                               ║
  320.          ║ 3A  ░   [ Add Xref Area ]            [Cancel]       ║
  321.          ║ 3D  ░                                               ║
  322.          ║ 3E  ░   [Pick Area]     [Save ]      [Delete]       ║
  323.          ║ 3G  ░                                               ║
  324.          ╚═════════════════════════════════════════════════════╝
  325.  
  326.        3. Compression Methods: The compression methods you deal with
  327.           should be entered here with the corresponding extraction and
  328.           compression commands. If the programs called here are not in
  329.           your path, use the full path names. If you use ARJ you will
  330.           need much memory, QRFM running ARJ seems to need about 500k.
  331.  
  332.          ╔═[■]════════════════════ Compression Methods ════════════════════╗
  333.          ║                                                                 ║
  334.          ║   Ext.   Extraction Cmnd     Compression Cmnd    Comments       ║
  335.          ║                                                                 ║
  336.          ║   ARJ    Arj e               Arj a -jt                          ║
  337.          ║   ZIP    PkUnZip             PkZip                              ║
  338.          ║   ARC    PkUnPak             PkPak a                            ║
  339.          ║   PAK    Pak e               Pak a                              ║
  340.          ║   SDN    Pak e               Pak a                              ║
  341.          ║                                                                 ║
  342.          ║                                                                 ║
  343.          ║              [  Ok  ]         [ Cancel]                         ║
  344.          ║                                                                 ║
  345.          ╚═════════════════════════════════════════════════════════════════╝
  346.  
  347.        4. Other External: Give the system the command that executes your
  348.           Directory manager and Virus checker. As with compression Methods
  349.           If the programs called here are not in your path, use the full
  350.           path names. The directory manager and Virus Scan programs
  351.           shown in the example below are Shareware programs selected for
  352.           the example because of their availability. They are found on
  353.           BBS's as DR.* And SCANV**.*. First give your favorite File
  354.           Manager and Virus checker a try.  A couple of other file
  355.           managers I tried worked fine and can be substituted for DR.
  356.           DF.EXE, Directory Freedom on my BBS as DF450.ZIP or DB.EXE
  357.           from Director Vers 4.5 on my BBS as DIRECTOR.ZIP.
  358.  
  359.  
  360.          ╔═[■]═══════════════ External Calls Config ════════════════════╗
  361.          ║                                                              ║
  362.          ║                                                              ║
  363.          ║    Dir Manager         DR                                    ║
  364.          ║                                                              ║
  365.          ║                                                              ║
  366.          ║    Virus Check         B:\Scan\Scan /D *.* /NOMEM            ║
  367.          ║                                                              ║
  368.          ║                                                              ║
  369.          ║                 [  Ok  ]         [ Cancel]                   ║
  370.          ║                                                              ║
  371.          ╚══════════════════════════════════════════════════════════════╝
  372.  
  373.        5. Import Files.BBS: when the rest of the setup is complete you
  374.           are ready for this function. All the Files.BBS files except
  375.           the one in your Upload directory are read in to the Data Base
  376.           along with File sizes and file dates. Orphan files are also
  377.           imported, and a list of any files that are called out in the
  378.           Files.BBS but not found in the Directory, is produced and
  379.           placed in the download directory. This function is intended to
  380.           be used only once. It can be repeated if for some reason files
  381.           have been added to the download directory without using QRFM.
  382.           If repeated this function only picks up files not already in
  383.           the Data Base. The reading of the Upload directory Files.BBS
  384.           is a seperate function and is found in the Pick_Lists Menu.
  385.           This function is not required if the BBS dosen't have files
  386.           yet.
  387.  
  388.   Operation:
  389.  
  390.     a. After the configuration has been established including the Import
  391.        of Download areas, Files.BBS, into the QRFM database, the system
  392.        is ready for use.
  393.        Any files that are in the upload directory should be imported at
  394.        this time. Use the Pick_List menu item [Load New Uploads], it
  395.        will import all files that haven't already been imported, into
  396.        the QRFM data base. A file does not have to be on the Files.BBS
  397.        list, Orphan files are also imported into the data base.
  398.        You can use this feature when adding files to the board. Just
  399.        place them in the Upload directory and import them, then use the
  400.        QRFM description edit function to add a description.
  401.        Descriptions read from the Upload Directory Files.BBS can be up
  402.        to 240 characters on the same line as the File name and starting
  403.        in column 14. When imported into the QRFM data base descriptions
  404.        are placed in lines 46 characters long. Only 7 lines can be
  405.        displayed by QRFM and only 240 character descriptions can be be
  406.        edited. Keep descriptions under 240 characters.
  407.  
  408.     b. Pick_Lists are used to select a file for processing by the the
  409.        functions in the File_Ops and OffLine_Ops menus. A file must be
  410.        high-lighted in a Pick_List before a file can be processed. Pull
  411.        up Pick_Lists by selecting one from the Pick_List menu with
  412.        mouse, function Key, or Alt key and menu item first letter. Close
  413.        a Pick_List with the F10 key or click on the upper left corner
  414.        with the mouse.
  415.  
  416.        Key presses available while traversing the Pick_Lists:
  417.            Home          HiLite Bar moves to first item
  418.            End           HiLite Bar moves to last item
  419.            PageUp        HiLite Bar moves up a page
  420.            PageDn        HiLite Bar moves down a page
  421.            Up Arrow      HiLite Bar moves up a line
  422.            Dn Arrow      HiLite Bar moves down a line
  423.            Enter         If a file is HiLited the file is uncompressed and
  424.                          your file manager is called to view it's contents
  425.                          If a file area is not displayed the HiLited file
  426.                          area will be displayed.
  427.            Left Arrow    If a file area is displayed it will be closed so
  428.                          so that another area can be opened.
  429.            Any Character The file HiLite bar will jump to the next or first
  430.                          File whos name starts with that character.
  431.            Space Bar     Mark a collection of files for a group move. The
  432.                          space bar can also unmark a marked file.
  433.            Tab           When in window that has a number of buttons and
  434.                          fields the Tab key can be used to the next button
  435.                          or field.
  436.  
  437.        The mouse can be use to select files, Menu items and buttons.
  438.        the Right mouse button when clicked on a file name functions as
  439.        the space bar and will mark that file for a group move.
  440.  
  441.     c. File_Ops functions are all pretty much self explanatory. A couple
  442.        of things that arn't, when working with files you must first
  443.        bring up one of the three Pick Lists. With the UpLoad or DnLoad
  444.        Pick list displayed all the File_Ops are active.
  445.        Select a file by clicking on it with the left mouse button or
  446.        using the Arrow keys to move to and high-lite the file. Once a
  447.        file name has been high-lighted use the mouse or Alt-f to select
  448.        the File_Ops menu.
  449.        When moving files an optional tag and move is supported. If the
  450.        Move menu item is selected and any files are taged they will be
  451.        moved instead of the HiLited file. Files are taged by pressing
  452.        the right mouse button or the space bar.
  453.        If during the functions (Recompress, File Manager or Virus Scan)
  454.        a file is encountered that dosen't have a Extension, that can be
  455.        found in the Setup, the following steps are taken:
  456.          If the file is a .EXE you will be asked if you want to try and
  457.          decompress it. If you answer no or if the file has any other
  458.          extension that isn't found it will be copied to the Qrfm Temp
  459.          subdirectory. And the selected function will be completed.
  460.        The Lower Description Case function will change the description
  461.        from UpperCase to LowerCase with the exception of the first
  462.        character in each word.
  463.  
  464.     d. OffLine_Ops are active when the DnLoad Pick list is being displayed.
  465.        In addition the OffLine_Opp menu items [Backup to Floppy] and
  466.        [Mark Backup N/R] are active when the NotBacked picklist is
  467.        displayed.
  468.        The menu item [Mark Backup N/R] will mark an item as not requiring
  469.        backup, an item so marked will not appear on the Not Backed pick
  470.        list.
  471.        If QRFM is told to backup a floppy you will be asked to place a
  472.        floppy in the A: drive. If room is available on an existing
  473.        backup disk, in the required backup group, that disk disk will be
  474.        requested otherwise a blank formated disk will be requested. Once
  475.        backed up a file can be taken offline and put back on line as
  476.        required. QRFM keeps track of offline status, floppy disk
  477.        numbers, and the space available on floppys. The maximum number
  478.        of files that QRFM can catalog on a floppy has been set at 21.
  479.  
  480.     e. The Locator menu provides quick access to info in the data base.
  481.        The Pick_Lists can not be displayed when using Locator menu
  482.        functions.
  483.  
  484.     f. The BBS_Lists menu has functions for updateing the BBS file
  485.        listings. The File lists are are not maintained during File_Ops
  486.        functions, and must be updated using the BBS_Lists functions or
  487.        using the QRFM utility QRFMFLst (see info on utilities below).
  488.        The AllFiles.Lst, BakUpDsk.Lst and Reference Area lists are
  489.        placed in the QRFM\LISTS subdirectory. The Function (Get XferDoor
  490.        DnLoad Counts) will only function if XferDoor is used for
  491.        downloads. It incorporates downloads made using XferDoor into the
  492.        QRFM Data Base. See the paragraph on XferDoor below. Reference
  493.        area lists are created in .ANS and .ASC format for display by the
  494.        BBS.
  495.  
  496.     g. The QRFM menu system
  497. ┌─────────────────────────────────────────────────────────────────────┐
  498. │ Exit  Pick_Lists  File_Ops  Offline_Ops  Locator  BBS_Lists  Config │
  499. └────────┬───────────────┬────────────┬───────┬─────────┬─────────────┘
  500.          │               │            │       │         └─────────┐
  501. ┌────────┴─────────────┐ │            │  ┌────┴─────────────────┐ │
  502. │ UpLoad File List F2  │ │            │  │ Filename Search      │ │
  503. │ DnLoad File Lists F6 │ │            │  │ Keyword Search       │ │
  504. │ NotBacked Up List    │ │            │  │ Backup Disk Contents │ │
  505. ├──────────────────────┤ │            │  └──────────────────────┘ │
  506. │ Load new Uploads     │ │            │                           │
  507. └──────────────────────┘ │            │                           │
  508. ┌────────────────────────┴┐  ┌────────┴───────────┐               │
  509. │ Move F5                 │  │ Backup to Floppy F7│               │
  510. │ Edit Description        │  │ Delete Backup Copy │               │
  511. │ Name Change             │  │ Take Offline       │               │
  512. │ Date Change             │  │ Put Back Online    │               │
  513. │ Kill File               │  │ Mark Backup N/R    │               │
  514. │ Add to Ref List         │  └────────────────────┘               │
  515. │ Cut from Ref List       │              ┌────────────────────────┴───┐
  516. │ Lower Description Case  │              │ UpLoad Files.BBS Update    │
  517. │ UpLoaded By Name Edit   │              │ DnLoad Files.BBS Update    │
  518. ├─────────────────────────┤              │ Write AllFiles List        │
  519. │ Recompress         F4   │              │ Reference Area Lists       │
  520. │ Search for Virus        │              │ Backup Disk File List      │
  521. │ File Manager            │              └────────────────────────────┘
  522. │ Virus Chk/File Mgr F3   │
  523. └─────────────────────────┘
  524.  
  525.                                          
  526.     h. Example PickList with File File DTP256.ARJ selected from the
  527.        File Area 1G.
  528.  
  529. Exit  Pick_Lists  File_Ops  Offline_Ops  Locator  BBS_Lists  Config
  530. ╔═[■]══════════════════════════ DnLoad Selector ═══════════════════════════════╗
  531. ║ Area    Graphics                                                             ║
  532. ║    ═╪══════════════════════════════════════════════════════════════════════  ║
  533. ║ 1A  ░   DANFLIK2.ZIP    ────────Area Info─────────────────────────────────   ║
  534. ║ 1B  ░   DANFLIK3.ZIP  ░  Path: D:\_Graph                                     ║
  535. ║ 1C  ░   DAZE41.ZIP    ░  Space Avail=219316224                               ║
  536. ║ 1D  ░   DAZZLE.ZIP    ░                           Area Access Level: 5       ║
  537. ║ 1E  ░   DAZZLE12.ZIP  ░  ────────File Info─────────────────────────────────  ║
  538. ║ 1F  ░   DBWRENDR.ZIP  ░  #:49        Size:274918    Date:10/29/1991          ║
  539. ║ 1G══░   DIGPRNT.ZIP   ░  XRef Areas: A                      Dnloads: 4       ║
  540. ║ 1H  ░   DOSEYE.ZIP    ░  Backup Group:06                                     ║
  541. ║ 1I  ░   DRAFTC.ZIP    ░   Uploaded By: Paul Jones                            ║
  542. ║ 1J  ░   DTP16.ZIP     ░  ────────File Description──────────────────────────  ║
  543. ║ 1K  ░══ DTP256.ARJ ═══░  DeskTop Paint 256. VGA Drivers for ATI,             ║
  544. ║ 2A  ░   DUMP0891.ARJ  ░  Headland & Paradise cards. A full colour            ║
  545. ║ 2B  ░   E2VGA5.ZIP    ░  bitmapped paint program uses the extended           ║
  546. ║ 2C  ░   EASYCASE.ZIP  ░  resolution of super VGA. Full colour                ║
  547. ║ 2D  ░   EDRAW320.ZIP  ░  manipulation and drawing, output in PCX, GIF,       ║
  548. ║ 3A  ░   EEDRAW.ARJ    ░  IFF/LBM, TIFF formats.                              ║
  549. ║ 3B  ░   EGA2VGA3.ZIP  ░                                                      ║
  550. ║ 3C  ░   EGAGRAPH.ZIP  ░                                                      ║
  551. ║ 3D  ░   EGALASER.ZIP  ░                                                      ║
  552. ╚══════════════════════════════════════════════════════════════════════════════╝
  553.  F2 Ups  F3 Chk  F4 Comp  F5 Move  F6 Dns  F7 Bak  F8 Info  F9 DOS  F10 Close
  554.  
  555.     i. The status line offers a one key press short cut to some of the
  556.        more often used functions.
  557.  
  558.  
  559.  
  560.   Recovery from a Hard Disk Crash:
  561.  
  562.     Backup the QRFM .Cfg and .Dat files on a regular basis in
  563.     preparation for an eventual hard disk crash. As a minimum the .Dat
  564.     files should be backed up each day in which download area files have
  565.     been backed to floppy. If the QRFM backup dosen't reflect the
  566.     condition of the backups on floppy, there is no way for QRFM to
  567.     recover the location of those files. I guess I could write a utility
  568.     to verify that the data, on the backup flopies, is in the database.
  569.     I have over 600 flopies that verifying would be a bit much.
  570.  
  571.     If a crash wipes out the QRFM directory/files restore them from
  572.     backup and run the utility ReBldIdx.EXE to generate the .Idx index
  573.     files, if they wern't included in the backup. If the QRFM
  574.     directories were lost be sure to re-create the QRFM sub directories.
  575.     Then restore any of the DownLoad/UpLoad directory structure that was
  576.     wiped out. Files.BBS are not needed QRFM will create them. QRFM
  577.     won't create missing directories, you must create them. (a possible
  578.     future QRFM revision). Missing files or files not recorded in the QRFM
  579.     backup, are not a problem. After the system again matches the QRFM
  580.     configuration data, run the utility VerifDb.Exe from the QRFM
  581.     directory.
  582.  
  583.  
  584.     VerifDb will check each file entry in the QRFM data base against the
  585.     actual files in the download directories and it will update the
  586.     files on line status. No need to place files that were lost in the
  587.     crash back on line prior to running VerifDB, all files backed up
  588.     using QRFM and not found on line will be statused as OffLine.
  589.  
  590.     QRFM recorded files that were lost and had not been backed up will
  591.     be deleted from the QRFM data base and are reported in a file named
  592.     VerifDb.Log that will be placed in the QRFM directory. The QRFM
  593.     backup may be a bit out of date so the download directories will be
  594.     checked for files that arn't in the QRFM data base. Files found in
  595.     the download directories that are not recorded in the QRFM backup,
  596.     will be added to the QRFM data base with out a description and will
  597.     be reported in VerifDb.Log. The QRFM edit function can be used to
  598.     describe the file.
  599.  
  600.  
  601.   Systens that have a CDROM:
  602.  
  603.     When importing files during QRFM setup if CDROM files.BBS's are to be
  604.     imported place files.BBS in the QRFM Lists directory under the name
  605.     FilesXX.BBS, one for each CDROM directory. Substitute the two
  606.     character QRFM file area designator for XX in the file name. If QRFM
  607.     dosn't find a Files.BBS in the File Area it will look in the Lists
  608.     directory. Description changes will be written to the FilesXX.BBS.
  609.  
  610.  
  611.  
  612.   Utilities and related programs:
  613.  
  614.     The following programs are not required in order to use QRFM, they
  615.     provide added features if you want or need them.
  616.  
  617.   1. SrchDoor
  618.  
  619.      a. SrchDoor does fast file name and new file searches are valuable
  620.         when the BBS searches are being slowed down by a large file
  621.         collection. SrchDoor makes use of the QRFM database to provide
  622.         fast and complete NewFile and FileName searches. SrchDoor will
  623.         also do description word searches. Another use for SrchDoor is
  624.         to restrict searches to particular directories. SrchDoor looks
  625.         in the default directory for ExitInfo.BBS and the BBS config file,
  626.         and uses the environment variable QRFM=C:\QRFM to locate the
  627.         QRFM files.
  628.  
  629.      b. SrchDoor will only work with QuickBBS Vers 2.75 or Remote
  630.         Access Vers 1.10/1.11. It will not work with other BBS systems
  631.         as it requires ConFig.RA or QuickCfg.Dat and the associated
  632.         ExitInfo.BBS.
  633.  
  634.      c. Two seperate Search menus can be called using a type 15 or 7 door.
  635.         The command line parameter "S" will cause SrchDoor to use it's
  636.         File Search Menu and the parameter "S" will bring up the New
  637.         Files Menu. Command line params can also be included to spell
  638.         out the file areas that are to be searched. SrchDoor will only
  639.         display areas that fall within the user security level. An
  640.         example of how to call the door from your BBS batch file
  641.         follows. Samples of the menus are also below.
  642.  
  643.  
  644.         to search all areas              to search selected areas
  645.         use:                             use:
  646.  
  647.           :FileSrch                        :FileSrchPgm
  648.             C:                               C:
  649.             Cd\QRFM                          CD\QRFM
  650.             SrchDoor S                       SrchDoor S TP TC TA
  651.             GoTo Restart                    GoTo Restart
  652.  
  653.           :NewFileSrch                      :NewFileSrchPgm
  654.             C:                                C:
  655.             Cd\QRFM                           Cd\QRFM
  656.             SrchDoor N                        SrchDoor N TP TC TA
  657.             GoTo Restart                      GoTo Restart
  658.  
  659.         The two character parameters in the examples to the right are
  660.         area codes identifying file areas that a search is to be limited
  661.         to.
  662.  
  663.         SrchDoor will run in stand alone local mode and as a door in
  664.         on-line door or in local mode.
  665.  
  666.         If not running SrchDoor from the QRFM system directory, it is
  667.         necessary to add the environment variable SET QRFM=C:\QRFM, set
  668.         it to whatever directory QRFM is in.
  669.  
  670.    ╔════════════════════════════════════════════════════════════════════════╗
  671.    ║                           Search for a File                            ║
  672.    ╠════════════════════════════════════════════════════════════════════════╣
  673.    ║                   1    File Name Search                                ║
  674.    ║                   2    Description Key Word Search                     ║
  675.    ║                   Q    Exit New File Search                            ║
  676.    ╠════════════════════════════════════════════════════════════════════════╣
  677.    ║    QRFM SrchDoor - by John Jamieson - Mt. Retreat BBS (408)335-4595    ║
  678.    ╚════════════════════════════════════════════════════════════════════════╝
  679.   Input :
  680.  
  681.    ╔════════════════════════════════════════════════════════════════════════╗
  682.    ║                            New File Search                             ║
  683.    ╠════════════════════════════════════════════════════════════════════════╣
  684.    ║                   1    New Files Since Last Date Called                ║
  685.    ║                   2    Files Added in the Past Week                    ║
  686.    ║                   3    Files Added in the Past Month                   ║
  687.    ║                   4    New Files as of mm-dd-yy                        ║
  688.    ║                   5    New Files as of X Days ago                      ║
  689.    ║                   Q    Exit New File Search                            ║
  690.    ╠════════════════════════════════════════════════════════════════════════╣
  691.    ║    QRFM SrchDoor - by John Jamieson - Mt. Retreat BBS (408)335-4595    ║
  692.    ╚════════════════════════════════════════════════════════════════════════╝
  693.   Input :
  694.  
  695.  
  696.      d. SrchDoor.EXE is included in the QRFM package.
  697.  
  698.      e. Trouble shooting the SrchDoor installation:
  699.  
  700.          The Status bar can be an aid in trouble shooting the door
  701.          installation.
  702.         a.  No status bar indicates that the BBS config file was not
  703.             found and QRDB is running in stand alone local mode.
  704.         b.  A status bar with a Baud rate other than 0 indicates the
  705.             Exitinfo.BBS file has been read, QRDB has Config and user
  706.             info and is running as a door.
  707.         c.  If the status bar shows a baud rate of 0 and user name in
  708.             the status bar is Sysop then the BBS config file has been
  709.             read, no Exitinfo.BBS has been found and QRDB is running in
  710.             stand alone local mode.
  711.         d.  If the status bar shows a baud rate of 0 and user name in
  712.             the status bar is NOT Sysop then the BBS config file has
  713.             been read, Exitinfo.BBS has Read and QRDB is running as a
  714.             door in local mode.
  715.  
  716.  
  717.   2. QRFMSrch
  718.  
  719.     QRFMSrch is a stand alone Search utility. It more or less duplicates
  720.     the features of SrchDoor. It only needs the QRFM data base to
  721.     function, it dosen't need access to the BBS and it's directories. If
  722.     not running QRFMSrch from the QRFM system directory , it is
  723.     necessary to add the environment variable SET QRFM=C:\QRFM, set it
  724.     to whatever directory QRFM is in.
  725.  
  726.   3. QRFMFLst
  727.  
  728.     QRFMFLst is a utility that can be run from a batch file. It will
  729.     accomplish the QRFM BBS List functions and then some. Command line
  730.     parameters are used to tell QRFMFLst the functions that are to be
  731.     accomplished. If not running QRFMFLst from the QRFM system
  732.     directory, it is necessary to add the environment variable SET
  733.     QRFM=C:\QRFM, set it to whatever directory QRFM is in.
  734.  
  735.     If you use XferDoor then the -F option will obtain DownLoad Counts
  736.     and the name of the User that uploads a file from files created by
  737.     XferDoor.
  738.     If you don't use XferDoor then the -O option will accomplish the
  739.     same tasks as the -F option, obtaining Names and Download counts
  740.     from the UpLoads and DnLoads logs. This -O option puts a copy of the
  741.     last DnLoads.Log line read into a Textfile called LastDn.Log in the
  742.     QRFM directory. If that file is not found the complete DnLoads log
  743.     will be processed, so don't delete it unless you also delete the
  744.     DnLoads.Log. If you are switching from XferDoor to another Transfer
  745.     Door you will want to create LastDn.Log or start with a new DnLoads
  746.     Log so that Downloads already counted don't get counted again. This
  747.     -O option could be time consuming if the UpLoads and DnLoads Logs
  748.     are allowed to get very long.
  749.  
  750.  
  751.     QRFMFLst -F                         will accomplish the QRFM menu items
  752.                                         Use this  option if you USE
  753.                                         XferDoor to handle file transfers
  754.                                            a. Load new Uploads
  755.                                            b. Get Xferdoor DnLoad counts if
  756.                                               available
  757.                                            c. UpLoad Files.BBS Update
  758.                                            e. DnLoad Files.BBS Update
  759.  
  760.     QRFMFLst -O                         will accomplish the QRFM menu items
  761.                                         Use this  option if you DON'T USE
  762.                                         XferDoor to handle file transfers
  763.                                         and want to use the DnLoads.Log to
  764.                                         obtain download counts.
  765.                                            a. Load new Uploads
  766.                                            b. Get DnLoad counts from DnLoads
  767.                                               Log
  768.                                            c. UpLoad Files.BBS Update
  769.                                            e. DnLoad Files.BBS Update
  770.  
  771.     QRFMFLst -R                         will accomplish the QRFM menu item
  772.                                         Reference Area Lists, updating
  773.                                         all Reference Area lists.
  774.                                         Reference area lists are created
  775.                                         in .ANS and .ASC format for
  776.                                         display by the BBS.
  777.  
  778.     QRFMFLst -L Level                   will Generate a Allfiles List
  779.                                           QRFMFLst -L 50
  780.                                           would Generate a Allfiles List
  781.                                           and include only areas with a
  782.                                           security level less than 50.
  783.  
  784.     QRFMFLst -S Adult.Lst D G1          Will Generate a list of the files
  785.                                         in file areas D and G1 and place it
  786.                                         in the lists subdirectory under the
  787.                                         name Adult.Lst.
  788.  
  789.     QRFMFLst -D Character               Will Generate a files list for each
  790.                                         area with a name that is generated as
  791.                                         follows. Character+File Area key+.DIR
  792.  
  793.     The lists generated by the -S and -L switches can include a header
  794.     of your design. Create a list header and place it in a File with
  795.     the extension .HDR  and same name as the file it is to be used with.
  796.     Place the file in the lists subdirectory and it will be included
  797.     when the file list is generated.
  798.  
  799.     Command line parameters can be combined, but LIMIT the Length of the
  800.     parameter string to 100 characters.
  801.     Example:    QRFMFLst -F -R -L 50 -S Adult.Lst D G1  -S Prog.Lst 1 2 3
  802.     I had some problems with very long command lines and as yet don't
  803.     know what QRFMFLst command line limits are. My longest command line
  804.     at this time is 70 characters. If length becomes a problem just run
  805.     the program again.
  806.  
  807.  
  808.  
  809.   4. XferDoor
  810.  
  811.     XferDoor when used in conjunction with QRFM provides added features
  812.     in both QRFM and XferDoor. Qrfm will be given the name of a File
  813.     UpLoader and in addition DnLoad counts are passed to QRFM. XferDoor
  814.     will use the QRFM database to determine if a file is already on the
  815.     BBS. Existing files, includeing offline files can then be rejected.
  816.     XFERDR65.ARJ is the latest normal release at this time. It Supports
  817.     both QuickBBS Vers 2.75 and RA Vers 1.10/1.11. If XferDoor is
  818.     XferDr71.ARJ can be downloaded from Mountain Retreat at
  819.     (408)335-4595 or Freq the magic name XferDoor from 1:216/506.  A
  820.     multiNode Beta version of XferDoor is also available it is
  821.     XferDr7k.ARJ. XferDoor requires the QRFM environment variable be
  822.     set. (SET QRFM=C:\QRFM), set it to whatever directory QRFM is in.
  823.  
  824.  
  825.    5. CntDown
  826.  
  827.     CntDown will read DnLoads.Log file and record the download count in
  828.     the QRFM Data Base. CntDown can be used only once on a DnLoads.Log.
  829.     If you run this more than once on the same DnLoads.Log your download
  830.     count would be doubled.
  831.     This utility was intended to used only once, with the program
  832.     QRFMFLst being used for maintaining download counts after CntDown
  833.     establishes a baseline.
  834.     This program wants to be run from your QRFM directory.
  835.  
  836.  
  837.    6. UpBy
  838.  
  839.     UpBy reads the UpLoads.Log file and records the name of the user
  840.     that uploaded each file into the QRFM Data Base. As with CntDown,
  841.     this utility was intended to used only once,
  842.     to established a baseline.
  843.     Like CntDn this program must be run from the QRFM directory.
  844.  
  845.  
  846.    7. ReBldIdx
  847.  
  848.     This utility can be used as part of a backup system, it makes
  849.     the backup of .IDX files un-necessary as they can be regenerated
  850.     with this utility.
  851.  
  852.  
  853.    8. VerifDb
  854.  
  855.     VerifDb is required only in the event the QRFM data base and
  856.     directories/files become out of sync due to a hard disk crash,
  857.     additions/deletions of files outside of QRFM (a NoNo) or whatever.
  858.     See Recovery from a Hard Disk Crash above for info on it's use.
  859.  
  860.  
  861.  
  862.   History:
  863.  
  864.     Version 2 fixed a bug that caused problems in Index files when the
  865.     index file size reached 32k. A function was added to the OffLine_Ops
  866.     Menu, Mark Backup N/R. This function will mark files not requiring
  867.     backup, keeping them off of the NotBacked Up PickList. Reference
  868.     area lists are created in .ANS and .ASC format for use with Type 45
  869.     or Type 5 menu types.
  870.  
  871.     Version 3.0 adds file taging for group moves and a jump to feature.
  872.     With the jump to feature, if a pick list of files is displayed pressing
  873.     a character will jump to the first file whos name starts with that
  874.     character. The utility VerifyDB.Exe was added, it was created mainly
  875.     for use in the event of Hard Disk problems.
  876.  
  877.     Version 3.0a corrects a few minor glitches discovered after the 3.0
  878.     release.
  879.  
  880.     Version 3.0b adds the File functions, Lower Description Case and
  881.     UpLoaded By Name Edit. It also corrects problems in the utilities
  882.     VerifDB and ReBldIdx. They were flawed and the files they created
  883.     did not totally match the actual condition of the BBS files.
  884.  
  885.     Version 3.1 corrects a problem with a disappearing highlite bar in
  886.     the NotBacked Up Pick List. It also eliminates a bug that prevented
  887.     a download area's associated backup area from being changed to a new
  888.     non existing area. Made a change to the Load new Uploads function,
  889.     on compleation of this function the user is now presented with the
  890.     Upload Files Pick List. A Config menu option for selecting A or B
  891.     drives for floppy backups was added. Docs cleaned up a bit.
  892.  
  893.     Version 3.1a corrects a glitch in the new backup drive selection
  894.     function. It also adds ReCompress and BackUp to the selections
  895.     on the status line. Corrected an alignment problem in the positioning
  896.     of extended description lines displayed by QRFMSrch and SrchDoor.
  897.  
  898.     Version 3.1b corrects a problem that prevented QRFM from creating a
  899.     new config file. Also added message notifying user if memory at
  900.     startup is inadequate.
  901.  
  902.     Version 3.2 SrchDoor will now work on Multinode systems. Also fixed
  903.     a problem with SrchDoor repeating a record when doing a word search
  904.     if that word was repeated in the record. QRFM and QRFMFLst will
  905.     obtain the uploaders name from the UpLoads log if XferDoor is not
  906.     providing the info. QRFMFLst will obtain download counts from the
  907.     DnLoads log if XferDoor isn't providing them.
  908.  
  909.     Version 3.3 Beta. Support for CDROM directories added. A message
  910.     stateing that QRFM is working will now be displayed during time
  911.     consuming processes. Areas can now be imported 1 at a time (Config
  912.     Menu).
  913.  
  914.     Version 3.4 minor changes to beta version.
  915.  
  916.     Version 3.5 SrchDoor revised by adding HotKey feature and an
  917.     additional New Files menu item.
  918.  
  919.     Version 3.6 Set 535k as minimum memory requirement.
  920.  
  921.     Version 36a bugfix in QRFM and QRFMFLST Import Upload routines.
  922.  
  923.    Disclaimer agreement
  924.  
  925.     Users of QRFM and it's utilities must except the following disclaimer
  926.     agreement:
  927.  
  928.     QRFM and it's utilities are provided AS IS. The Author makes no
  929.     Warranty of any kind, expressed or implied. In addition THE AUTHOR
  930.     ASSUMES NO LIABILITY FOR DAMAGES WHICH MAY RESULT WHICH MAY RESULT
  931.     FROM THE USE OF QRFM or it's utilities.
  932.  
  933.     QRDB is ShareWare, a $15 registration fee is required. For an
  934.     additional $10 I'll send you a copy of the latest version with with
  935.     a 65 character message of your choice replacing the following line
  936.     in the QRFM SrchDoor menu.
  937.  
  938.    ╠════════════════════════════════════════════════════════════════════════╣
  939.    ║    QRFM SrchDoor - by John Jamieson - Mt. Retreat BBS (408)335-4595    ║
  940.    ╚════════════════════════════════════════════════════════════════════════╝
  941.  
  942.    If you decide to continue useing QRFM after a 90 day trial period
  943.    you are expected to register. Please send your registration fee to:
  944.  
  945.              John Jamieson
  946.              Mountain Retreat BBS
  947.              555 Buckeye St.
  948.              Felton Ca, 95018
  949.  
  950.     For support contact:
  951.  
  952.              Fidonet 1:216/506
  953.              InterNet johnj@clovis.ca.us
  954.              BBS phone (408)335-4595
  955.  
  956.